home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / music / melody21.arj / MELODY21.EXE / MM.DOC < prev    next >
Text File  |  1992-07-26  |  38KB  |  932 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                      M E L O D Y    M A S T E R
  7.  
  8.                             Version 2.1
  9.  
  10.  
  11.  
  12.  
  13.                      ==========================
  14.                       U S E R ' S    G U I D E
  15.                      ==========================
  16.  
  17.  
  18.  
  19.  
  20.       
  21.       
  22.  
  23.                       p r o g r a m m e d   b y
  24.  
  25.                          Alexei A. Efros, Jr.
  26.                        4544 South Brockbank Dr.
  27.                   Salt Lake City, Utah 84124, U.S.A.
  28.  
  29.  
  30.                         m a r k e t e d   b y
  31.  
  32.                    Shareable Software International
  33.                             PO Box 59102
  34.                     Schaumburg, IL  60159, U.S.A.
  35.                                                     
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                          _______
  42.                     ____|__     |                (R)
  43.                  --|       |    |-------------------
  44.                    |   ____|__  |  Association of
  45.                    |  |       |_|  Shareware
  46.                    |__|   o   |    Professionals
  47.                  -----|   |   |---------------------
  48.                       |___|___|    MEMBER
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                    Copyright 1990-92 by A.A.Efros
  56.                          All Rights Reserved
  57.  
  58.  
  59.  
  60. MELODY MASTER                                                    Page 2
  61.  
  62.  
  63.                           Table of contents
  64.  
  65.  
  66.       IMPORTANT LEGAL INFORMATION . . . . . . . . . . . . . . . . . . 3
  67.  
  68.       REGISTRATION INFORMATION. . . . . . . . . . . . . . . . . . . . 4
  69.             WHAT DO YOU GET FOR REGISTRATION ?. . . . . . . . . . . . 4
  70.             OBTAINING A "COMMERCIAL LICENSE" WILL ALSO PROVIDE YOU. . 5
  71.  
  72.       WHAT OTHERS SAY ABOUT MELODY MASTER . . . . . . . . . . . . . . 6
  73.  
  74.       INTRODUCTION. . . . . . . . . . . . . . . . . . . . . . . . . . 7
  75.  
  76.       REQUIREMENTS. . . . . . . . . . . . . . . . . . . . . . . . . . 7
  77.  
  78.       GETTING STARTED . . . . . . . . . . . . . . . . . . . . . . . . 7
  79.  
  80.       PROGRAM SCREENS . . . . . . . . . . . . . . . . . . . . . . . . 8
  81.  
  82.       MUSIC NOTATION. . . . . . . . . . . . . . . . . . . . . . . . . 8
  83.  
  84.       WRITING AND EDITING MUSIC . . . . . . . . . . . . . . . . . . . 9
  85.  
  86.       SUMMARY OF COMMANDS . . . . . . . . . . . . . . . . . . . . . .11
  87.  
  88.       SUMMARY OF FUNCTIONS. . . . . . . . . . . . . . . . . . . . . .12
  89.  
  90.       MUSIC LIBRARY (*.MEL) . . . . . . . . . . . . . . . . . . . . .14
  91.  
  92.       ADDITIONAL UTILITIES. . . . . . . . . . . . . . . . . . . . . .14
  93.             Configuration Utility . . . . . . . . . . . . . . . . . .14
  94.             PLAY-to-MEL Conversion Utility. . . . . . . . . . . . . .15
  95.             MUS-to-MEL Conversion Utility . . . . . . . . . . . . . .16
  96.             PAGING utility. . . . . . . . . . . . . . . . . . . . . .16
  97.             PLAY command. . . . . . . . . . . . . . . . . . . . . . .16
  98.  
  99.       DESCRIPTION OF FILES. . . . . . . . . . . . . . . . . . . . . .17
  100.       
  101.       HOW TO GET HELP . . . . . . . . . . . . . . . . . . . . . . . .18
  102.       
  103.       ABOUT THE AUTHOR. . . . . . . . . . . . . . . . . . . . . . . .18
  104.  
  105.       ACKNOWLEDGEMENTS. . . . . . . . . . . . . . . . . . . . . . . .19
  106.  
  107.  
  108.  
  109. MELODY MASTER                                                    Page 3
  110.  
  111.  
  112.       ***************** IMPORTANT LEGAL INFORMATION ****************
  113.  
  114.  
  115.                          Melody Master, Version 2.1
  116.  
  117.  
  118.       This software is provided in its current configuration.  The
  119.       author makes no warranty of any kind, whether expressed or
  120.       implied, including, without limitation, any warranties of
  121.       merchantability or suitability for a particular purpose.
  122.  
  123.       Melody Master is NOT a public domain program. It is Copyright
  124.       (c) 1990-92 by Alexei A. Efros, Jr. All rights are reserved.
  125.  
  126.       Melody Master software and its accompanying documentation are
  127.       protected by United States Copyright laws as well as by
  128.       International Treaty provisions.  Any use of this software in
  129.       violation of the copyright laws or the terms of this limited
  130.       license will be prosecuted to the fullest extent of the law.
  131.  
  132.       The author, Alexei A. Efros, Jr., hereby grants you a limited
  133.       license to use this software for evaluation purposes for a
  134.       period not to exceed thirty (30) days.  If you decide to
  135.       continue using this software (and/or its documentation) after
  136.       the thirty (30) day evaluation period, you MUST register your
  137.       copy with a registration payment to the author.
  138.  
  139.       Use of this program beyond the thirty (30) day evaluation
  140.       period, without registering the software, is a violation of
  141.       the terms of this limited license.
  142.  
  143.       No licensee shall use, copy, rent, lease, sell, modify,
  144.       decompile, disassemble, otherwise reverse engineer, or
  145.       transfer the licensed program except as provided in this
  146.       agreement.  Any such unauthorized use will result in
  147.       immediate and automatic termination of this license.
  148.  
  149.       A Commercial License is required for any use of the Melody
  150.       Master output files in for-profit software.
  151.  
  152.       All rights not expressly granted in this limited license are
  153.       reserved by the author.
  154.  
  155.  
  156.  
  157. MELODY MASTER                                                    Page 4
  158.  
  159.  
  160.              =================================================
  161.               R E G I S T R A T I O N   I N F O R M A T I O N
  162.              =================================================
  163.  
  164.  
  165.             Support Shareware by registering today! Thank you!
  166.  
  167.       If you are not familiar with the Shareware concept, refer to
  168.       the shareware document file (SHR-WARE.DOC) on the program disk.
  169.  
  170.       To register your copy of Melody Master, print the registration
  171.       form (INVOICE.TXT file on the program disk), fill it out, and
  172.       send it to the address provided. Or use your Visa or MasterCard
  173.       and call 1-800-622-2793!
  174.  
  175.  
  176.     ----------------------------------
  177.     WHAT DO YOU GET FOR REGISTRATION ?
  178.     ----------------------------------
  179.                                      
  180.       
  181.     Newest Version with more Melodies
  182.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  183.       Each registered user will receive the newest version of Melody
  184.       Master on disk. Because we couldn't fit all the melodies here
  185.       the disk will also contain over 60 more melodies for your
  186.       enjoyment.
  187.       
  188.       
  189.     Registration Number
  190.     ~~~~~~~~~~~~~~~~~~~
  191.       Each registered user will also receive a unique registration
  192.       number with the program update. When the registration update is
  193.       installed, the Registration Reminder Screen (RRS) will be
  194.       removed from the opening and closing screens of the program.
  195.       Your name will be shown in the "About..." screen and in the
  196.       program startup.
  197.     
  198.       
  199.     Printed User's Guide:
  200.     ~~~~~~~~~~~~~~~~~~~~~
  201.       You will receive your 5 1/2 by 8 1/2 printed manual.
  202.       
  203.       
  204.     Technical Support
  205.     ~~~~~~~~~~~~~~~~~
  206.       Lifetime technical support by mail for all registered users. The
  207.       support may also be obtained thru telephone, CompuServe,
  208.       Internet, and the Runway BBS (conf. 77).
  209.  
  210.  
  211. MELODY MASTER                                                    Page 5
  212.       
  213.       
  214.     Future Upgrades
  215.     ~~~~~~~~~~~~~~~
  216.       Your registration number is valid for upgrades within the same
  217.       version number of the program. Simply obtain the new version
  218.       from your favorite BBS or disk vendor and install your
  219.       registration number. This does not include upgrades from 2.x to
  220.       3.x etc. You will be notified about major upgrades by mail.
  221.                                              
  222.       
  223.     Free CompuServe Introductory Membership
  224.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  225.       When you register Melody Master you also get a free CompuServe
  226.       Introductory Membership. This Introductory Membership includes
  227.       your User ID, Password, and a $15.00 usage credit. When you sign
  228.       on with your free Introductory Membership you will also receive
  229.       a free, one year subscription to CompuServe Magazine. This
  230.       CompuServe Introductory Membership has a suggested retail price
  231.       of $39.95 but is free to registered users of our products.
  232.                                                
  233.       
  234.     Discount on Shareware Magazine subscription
  235.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  236.       You will receive more than 50% off the subscription to one of
  237.       the best shareware magazines! The normal 1 year subscription is
  238.       $20 but you can get it for just $9.97!
  239.       
  240.       
  241.     A Good Feeling
  242.     ~~~~~~~~~~~~~~
  243.       Best of all, you will enjoy a good feeling from supporting the
  244.       shareware concept!  You will also sleep better at night knowing
  245.       that the "people from the Copyright Office" won't be after you.
  246.  
  247.  
  248.  
  249.     -------------------------------------------------------
  250.     OBTAINING A "COMMERCIAL LICENSE" WILL ALSO PROVIDE YOU:
  251.     -------------------------------------------------------
  252.  
  253.  
  254.     The Right To Use Output Files
  255.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  256.       A commercial license allows programmers, businesses, agencies,
  257.       and other institutions to use the Melody Master output files
  258.       in their commercial programs. No royalties are required!
  259.  
  260.  
  261. MELODY MASTER                                                    Page 6
  262.                                                                        
  263.       
  264.  
  265.      ==================================================================
  266.         This  program  is produced by a member of the Association of
  267.         Shareware Professionals (ASP). ASP wants to make  sure  that
  268.         the  shareware principle works for you. If you are unable to
  269.         resolve a shareware-related problem with an  ASP  member  by
  270.         contacting the member directly, ASP may be able to help. The
  271.         ASP Ombudsman can help you resolve a dispute or problem with
  272.         an  ASP  member,  but does not provide technical support for
  273.         members' products. Please write to the ASP Ombudsman at  545
  274.         Grover  Road,  Muskegon  MI  49442-9427 or send a CompuServe
  275.         message via CompuServe Mail to ASP Ombudsman 70007,3536
  276.      ==================================================================
  277.  
  278.  
  279.  
  280.  
  281.     WHAT OTHERS SAY ABOUT MELODY MASTER
  282.                                                                    
  283.       
  284.  
  285.       "This is the best melody maker program I have ever seen!"
  286.                     - Robert L. A. Trost, CCI Ltd., The Netherlands
  287.       
  288.       
  289.       "My BBS serves home-school families. Your program is EXCELLENT for
  290.        working with children!!!"
  291.                     - Linda R. Bloon, Florida, USA
  292.       
  293.       
  294.       "Beautiful piece of work."
  295.                     - Familyware, Florida, USA
  296.       
  297.       
  298.       "I like your program very much"
  299.                     - M. Dyakonov, Ioffe Institute, St.Petersburg, USSR
  300.       
  301.       
  302.       "Publisher's choice"
  303.                     - Expert Software, Florida, USA
  304.       
  305.       
  306.       First Place Winner
  307.                     - UCCE Annual Programming Contest, Provo, Utah, USA
  308.       
  309.      
  310.  
  311. MELODY MASTER                                                    Page 7
  312.  
  313.  
  314.     INTRODUCTION
  315.  
  316.  
  317.       Melody Master is a music system that is designed for writing,
  318.       editing, and playing one-part melodies.  The program uses a
  319.       graphics interface that lets you view and edit the music in
  320.       sheet form.  Melody Master can be used in a variety of ways.
  321.       You can listen to the more than one hundred tunes that are
  322.       included with the program.  You can experiment with changing
  323.       the melodies that are included or write your own tunes.
  324.  
  325.       Melody Master will help you to teach yourself (or your children)
  326.       the principles of music notation and structure in an enjoyable
  327.       way.  For programmers or people who enjoy writing batch files,
  328.       Melody Master is an excellent tool for making your programs
  329.       "sing".  In whatever way you use it, Melody Master is easy to
  330.       use, functional, educational, and a lot of fun!
  331.  
  332.       Melody Master employs sharps, flats, dotted notes, and repeats,
  333.       provides four musical styles, seven note lengths, seven rests,
  334.       and approximately seven octaves, and uses up to 16 configurable
  335.       tempos.
  336.  
  337.       Melodies can be saved into the program's *.MEL files.  Or, the
  338.       output files can be converted and exported for use in BASIC
  339.       programs, Pascal procedures, "C" functions, ANSI Music, etc.
  340.  
  341.       Three conversion utilities allow you to convert PIANOMAN's *.MUS
  342.       files, BASIC's PLAY statements, and MM 1.5's *.MM files into
  343.       *.MEL files.  Thus, Melody Master is easily compatible with many
  344.       of the popular music systems for PCs.
  345.  
  346.  
  347.     REQUIREMENTS
  348.  
  349.       Melody Master operates on an IBM PC XT/AT, PS/2, or a 100%
  350.       compatible computer equipped with a CGA, MCGA, EGA, VGA, or
  351.       Hercules graphics card.  At least 512K of RAM is required.
  352.  
  353.  
  354.     GETTING STARTED
  355.  
  356.       At the command prompt. type START.  You will see a menu of
  357.       activities.  Choose 2 to run Melody Master with CGA or MCGA
  358.       graphics cards.  Choose 1 to run the program with all other
  359.       graphics cards.  Screen representation differences between the
  360.       standard Melody Master (file MM.EXE) and Melody Master for
  361.       CGA/MCGA (MMCGA.EXE) occur because CGA graphics are less
  362.       powerful than other graphics conventions.
  363.  
  364. MELODY MASTER                                                    Page 8
  365.  
  366.  
  367.    PROGRAM SCREENS
  368.  
  369.       If you have not registered your copy of Melody Master, you will
  370.       see a Registration Reminder Screen (RRS).  With the registered
  371.       version and EGA or VGA graphics, the RRS is replaced with a
  372.       picture of Johann Sebastian Bach.  Press any key to continue.
  373.  
  374.       Following the opening screen, you will see the music writing or
  375.       editing screen.  The top segment of the screen shows the name
  376.       of the composition, its length, the page number, and editing
  377.       mode.  The tempo, style, and octave boxes show the default
  378.       settings.  The next segment is a graph of five parallel lines
  379.       on which the music is written (called a staff).  The circle on
  380.       the middle line of the staff is similar to a cursor.  It shows
  381.       where notes and rests are to be placed.  Below the staff is the
  382.       Help box which may be toggled on or off using the F1 function
  383.       key.  At the bottom of the screen, the function keys are listed.
  384.  
  385.  
  386.     MUSIC NOTATION
  387.  
  388.       On the 5-line staff, the large S-like figure on the left side is
  389.       called a G-clef (or treble clef).  It specifies the placement of
  390.       the note G and the pitch or key of the music.  The arrows (or
  391.       triangles) above and to the right of the staff indicate the
  392.       position of note placement or editing.
  393.  
  394.       Notes are named using the first seven letters of the alphabet:
  395.       A, B, C, D, E, F, and G.  The lines and spaces of the staff are
  396.       named in succession from bottom to top.  In the case of the
  397.       staff on the screen, the G-clef indicates that the note G will
  398.       be on the second line from the bottom.  Thus, the notes on the
  399.       staff shown on the screen, counting the lines and spaces in
  400.       succession, and beginning with the bottom line, will be E, F,
  401.       G, A, B, C, D, E, and F.
  402.  
  403.       The lines are named E, G, B, D, and F.  The spaces between the
  404.       lines are named F, A, C, and E.  These notes correspond to the
  405.       white keys on a piano.
  406.  
  407.       A series of 8 successive notes on the staff form a scale.  An
  408.       8-note scale is named for the note on which it begins.
  409.  
  410.       Each note sounds for a specified amount of time.  Periods of
  411.       silence between notes are called rests.  A whole note (or whole
  412.       rest) is the basic unit of length within a given tempo and
  413.       style.
  414.  
  415.  
  416.  
  417. MELODY MASTER                                                    Page 9
  418.  
  419.  
  420.       In 4/4 time, a whole note sounds for four counts and a
  421.       whole rest lasts for four counts.  Notes and rests of a shorter
  422.       duration decrease in successive half-duration steps (e.g., whole
  423.       note, half-note, quarter-note, eighth-note, sixteenth-note
  424.       etc.).
  425.  
  426.       A dot after a note prolongs its value by half the duration of
  427.       the note (e.g., a four-count whole note with a dot sounds for
  428.       six counts.)
  429.  
  430.       Chromatic signs are placed before notes to raise or lower the
  431.       pitch of the note.  Sharps raise the pitch by a half note.
  432.       Flats lower the pitch by a half note.  As shown, the staff
  433.       is in the "Key of C".  In the Key of C, the chromatic signs
  434.       correspond to the black keys on a piano.
  435.  
  436.       Tempo indicates the speed at which the music is played.  The
  437.       program includes six standard tempos.  Allegro (lively, brisk,
  438.       rapid) is the default.  The tempo can be set to any speed with
  439.       the Configuration utility.
  440.  
  441.       Style indicates the amount of delay that will occur between
  442.       notes.  The program includes four preset styles.
  443.  
  444.       Octave indicates an eight-note measurement.  Press Control-PgUp
  445.       to raise the tone of the music by eight notes (one octave).
  446.       Control-PgDn lowers the music by one octave.
  447.  
  448.  
  449.     WRITING AND EDITING MUSIC
  450.  
  451.       To place a note, move the large circle to the line or space
  452.       where you want the note to appear.  Press 1 for a whole note,
  453.       2 for a half-note, 3 for a quarter-note, 4 for an eighth-note,
  454.       5 for a 16th-note, 6 for a 32nd-note, or 7 for a 64th-note.
  455.  
  456.       For a dotted note, hold down the ALT key and press the number as
  457.       indicated above (1-7).
  458.  
  459.       To place a rest, hold down the SHIFT key and press 1-7 for the
  460.       desired duration of the rest (pressing 1 for a whole note corresponds
  461.       to pressing SHIFT-1 for a whole rest.)
  462.  
  463.  
  464.  
  465.  
  466. MELODY MASTER                                                    Page 10
  467.  
  468.  
  469.       After you place a note or a rest, the cursor will automatically move
  470.       to the next position so that you can add another note or rest.  The
  471.       maximum number of entries (notes or rests) permitted for each melody
  472.       is 2560.
  473.  
  474.       To edit the musical entries, use the cursor keys.  Use the Right
  475.       and Left cursor keys to move the arrow above the staff over the
  476.       note you wish to change.  Then, use the Up and Down cursor keys
  477.       to place the arrow which is to the right of the staff at the
  478.       proper line or space.  Enter the desired note.
  479.  
  480.       If the INSERT mode is OFF, the new note will replace the previous
  481.       note.  If the INSERT mode is ON, the new note will be inserted and
  482.       the remaining note text of the tune will move one position to the
  483.       right.
  484.  
  485.       To delete a note, move the arrow above the staff one note
  486.       to the right of the note you want to delete.  Press the
  487.       BACKSPACE key to delete the note.
  488.  
  489.       The current octave status is shown on the screen in a window
  490.       called OCTAVE.  Two octaves can be seen and used on the staff
  491.       in the NORMAL setting.  To move further up the scale, one octave
  492.       (eight notes) at a time, use Ctrl-PgUp.  To move down the scale
  493.       one octave at a time, use Ctrl-PgDn.  When a note is entered in
  494.       this mode, it appears on a line above the staff.
  495.  
  496.  
  497. MELODY MASTER                                                    Page 11
  498.  
  499.  
  500.     SUMMARY OF COMMANDS
  501.  
  502.  
  503.       Cursor movement:
  504.       ---------------
  505.       Up / Down  (arrow keys)   - Move one line or space up/down
  506.       Left / Right (arrow keys) - Move one note left/right
  507.       PgUp / PgDn               - Move to the previous/next page
  508.       Home / End                - Move to the beginning/end of the tune
  509.  
  510.  
  511.       Note Representation:
  512.       -------------------
  513.       1  =  Full note              5  =  16th note
  514.       2  =  Half note              6  =  32nd note
  515.       3  =  Quarter note           7  =  64th note
  516.       4  =  Eighth note
  517.  
  518.  
  519.       Entering notation:
  520.       -----------------
  521.       1,2,3,4,5,6,7              -  Enter a note
  522.       Shift-1,-2,-3,-4,-5,-6,-7  -  Enter a rest
  523.       Alt-1,-2,-3,-4,-5,-6,-7    -  Enter a dotted note
  524.       +                          -  Enter a sharp
  525.       -                          -  Enter a flat
  526.       [ / ]                      -  Open / close repeat (reprise)
  527.  
  528.  
  529.       Editing:
  530.       -------
  531.       Backspace     -  Delete the previous note
  532.       Insert        -  Toggle Insert mode On/Off
  533.  
  534.  
  535.       Miscellaneous operations:
  536.       ------------------------
  537.       Ctrl-PgUp     -  Go up one octave (8 notes higher)
  538.       Ctrl-PgDn     -  Go down one octave (8 notes lower)
  539.       PgUp / PgDn   -  (in menus) go to next/previous page in the menu
  540.       Home / End    -  (in menus) go to the beginning/end of the list
  541.       Esc           -  Exit the current menu
  542.       Alt-X         -  Quit the program
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550. MELODY MASTER                                                   Page 12
  551.  
  552.  
  553.     SUMMARY OF FUNCTIONS
  554.  
  555.  
  556.       F1 - Toggle On/Off screen help window
  557.       -----------------------------------
  558.       To access the Melody Master Help Utility Window on the screen
  559.       while working with Melody Master, press F1.  To remove the Help
  560.       Window, press F1 again.  The initial status of the Help screen
  561.       can be setup with the Configuration Utility.
  562.  
  563.       F2 - Save a melody
  564.       ------------------
  565.       Save the current melody to the disk in *.MEL file format.  To
  566.       save the melody with the current name, press Y at the first
  567.       prompt.  To choose a different name, answer N at the prompt and
  568.       enter an eight-character name (the extension .MEL is automatic.)
  569.  
  570.       F3 - Load a melody
  571.       ------------------
  572.       This command opens a file window.  The initial screen of the
  573.       window lists the categories of tunes included in Melody Master.
  574.       Use the Up, Down, PgUp, and PgDn keys to select a category of
  575.       tunes and press ENTER.  The next screen shows the tunes in that
  576.       category that can be loaded.  Use the Up, Down, PgUp, and PgDn
  577.       keys to select a tune and press ENTER.  The tune loads.
  578.  
  579.       The lines "NAME\" and "..\" are directories.  Selecting one of
  580.       these lines and pressing ENTER will take you to that directory.
  581.  
  582.       The "* home *" line takes you back to the default directory (see
  583.       Configuration Utility). NOTE: Pressing ESC or loading a tune
  584.       does not automatically return you to the default directory! Keep
  585.       this in mind when saving tunes. Be sure you have selected the
  586.       directory in which you want the tune to be saved.
  587.  
  588.       F4 - Play a melody
  589.       ------------------
  590.       This command plays the melody that is loaded using current
  591.       settings.  To stop the melody, press ESC.
  592.  
  593.       F5 - Tempo
  594.       ----------
  595.       Select one of six preset tempos.  Allegro (lively, brisk, rapid)
  596.       is the Default tempo.  The configuration utility allows you to
  597.       create any tempo you choose.  (Many named tempos exist.)
  598.  
  599.  
  600.  
  601. MELODY MASTER                                                   Page 13
  602.  
  603.  
  604.       F6 - Debug play
  605.       ---------------
  606.       Plays the melody from the current cursor position and shows with
  607.       a small arrow where it is playing.  This is useful for finding
  608.       errors in the music.  Note that when Debug play goes from one
  609.       page to the next, an unnatural pause occurs.  Use F4 to play the
  610.       final melody in its natural form.
  611.  
  612.       F7 - Output files
  613.       -----------------
  614.       This command is used to generate the output as an ASCII file.
  615.       The ASCII file may contain commands or data for a specific
  616.       application such as Turbo Pascal, C, BASIC, 4DOS/NDOS, ANSI
  617.       Music, etc.  This allows music to be played from your own or
  618.       other programs or from batch files.  The TECH.DOC file on the
  619.       program disk contains a complete description of this process.
  620.  
  621.       F8 - Play a melody backwards.
  622.       ------------------------------
  623.       This command plays the entire melody backwards (just for fun!).
  624.  
  625.       The author has an interesting story about this command:
  626.           Once, I met with a friend who was studying music in college.
  627.           He was very upset because he had to write a music piece for
  628.           his final and just couldn't do it.  So, I recommended that
  629.           he take his professor's composition and play it backwards.
  630.           The next day he called me and said that he had played it
  631.           backwards and it sounded like the Moonlight Sonata!
  632.  
  633.       F9 - Miscellaneous Utilities
  634.       ----------------------------
  635.           New File   - Clears the memory of any existing music files.
  636.                        Also sets everything to default values.
  637.           Erase File - Erases a *.MEL file from disk.
  638.           8 up       - Moves the entire melody up 1 octave.
  639.           8 down     - Moves the entire melody down 1 octave.
  640.           About...   - Copyright note and registration information.
  641.           DOS Shell  - Shells to DOS. Type EXIT to get back.
  642.       
  643.       F10 - Sound on/off
  644.       ------------------
  645.       Toggles the sound on and off.  When sound is ON, each note is
  646.       heard as it is entered from the keyboard.  A small check mark is
  647.       also displayed in the upper right hand corner of the screen.
  648.       The default value is ON.
  649.       
  650.       Alt-F1 - Set style
  651.       ------------------
  652.       Sets one of four different styles in which to play the melody.
  653.       In Melody Master, style refers to a delay between notes.
  654.  
  655. MELODY MASTER                                                   Page 14
  656.  
  657.  
  658.     MUSIC LIBRARY (*.MEL)
  659.  
  660.       Melody Master Version 2.1 contains an extensive library of more
  661.       than 100 melodies of different kinds in different directories.
  662.       Most of them were converted from the MUZAK program and other
  663.       public domain programs primarily in BASIC.
  664.  
  665.       From the author:
  666.           I would like to thank all of these great programmers who
  667.           entered this music in an "old-fashioned" way.  I hope, now,
  668.           using Melody Master, you will make even more wonderful
  669.           music!  If you do, please give me a copy so I can add it to
  670.           the library.  If you wrote or entered a nice piece of music
  671.           you want to share with others, you can include it in later
  672.           versions of Melody Master by contacting me.  I would really
  673.           appreciate it!
  674.  
  675.       
  676.  
  677.     ADDITIONAL UTILITIES
  678.  
  679.       Configuration Utility
  680.       ---------------------
  681.  
  682.       Melody Master 2.1 contains its own configuration utility
  683.       (MMCONFIG.EXE) and configuration file (MMCONFIG.PAR).  Run
  684.       MMCONFIG.EXE from the DOS prompt or press 3 from START.BAT.
  685.  
  686.       After you have started the Configuration Utility, a main menu
  687.       appears on the screen.  Use the Up/Down arrow keys to highlight
  688.       the different options.  To choose an option, press ENTER.
  689.  
  690.       Select "Set Own Colors" to choose other screen foreground and
  691.       background colors for Melody Master.  If the colors chosen are
  692.       out-of-range for your monitor, you will not see any message or
  693.       notification, but Melody Master will use 0 (Black) for the
  694.       foreground and 1 (Blue) for the background.
  695.  
  696.       Select "Set Own Tempos" to add new tempos or change existing
  697.       ones.  The Tempo Window will show the name of a particular
  698.       tempo, an equal sign, and a number.  The number is a ratio which
  699.       is multiplied by the note-length to get the current tempo.  To
  700.       change a tempo, select the one to be changed and press ENTER.
  701.       To add a tempo, select the next available "Not Used" line and
  702.       press ENTER.  A maximum of 16 tempos may be specified.
  703.  
  704.  
  705.  
  706.  
  707. MELODY MASTER                                                   Page 15
  708.  
  709.  
  710.       Select "Set Own Lengths" to modify the note-lengths.  Lengths
  711.       are in milliseconds.  Select a new note-length and press ENTER.
  712.  
  713.       Select "Help On/Off" to choose either immediate or optional
  714.       help.  With immediate help, the help window appears when Melody
  715.       Master starts.  With optional help, the help window activates
  716.       only when F1 is pressed.  The default is immediate help.  After
  717.       the basic Melody Master commands have been learned, help can be
  718.       set to optional which will help to speed PC operations.
  719.  
  720.       Select "Library Path" to specify the start-up path to the music
  721.       files.  The path can be any relative directory (like "MUSIC\").
  722.       A period (.) or blank can also be entered for the current path.
  723.  
  724.       Select "Registration" to register your copy of Melody Master.
  725.       When your registration application is processed (see HOW TO
  726.       REGISTER) your Registration Name and Number will be sent to you.
  727.       Enter these EXACTLY as shown on the form you receive.  Remember
  728.       to save the new configuration.  After a successful registration,
  729.       you will not see the Registration Reminder Screen at the
  730.       beginning and the end of the program.  You can also unregister
  731.       the program by deleting your Registration Name and Number.
  732.  
  733.       Select "Set Defaults" to set everything to the default values.
  734.       The program reads the original data stored in the DEFAULT.PAR
  735.       file.  Remember to "Save" so that the changes take effect.
  736.       This command will also "unregister" you copy.
  737.  
  738.       Select "Save & Exit" to quit the program and save any changes in
  739.       MMCONFIG.PAR.  If the file does not exist, it will be created.
  740.  
  741.  
  742.       PLAY-to-MEL Conversion Utility
  743.       ------------------------------
  744.  
  745.       File name is PLAY2MEL.EXE.
  746.       This utility can convert music codes from BASIC's PLAY statements
  747.       into *.MEL files.  Before converting, edit your music code file
  748.       so that it contains nothing but the actual codes (no line
  749.       numbers and no "PLAY" commands).  PLAY-to-MEL cannot convert
  750.       "Nn" notation and "Tn" directive.  You will normally receive a
  751.       few warnings, but the resulting file may be okay.  Do NOT expect
  752.       perfect results!  Be prepared to edit the resulting file.
  753.  
  754.  
  755.  
  756.  
  757. MELODY MASTER                                                   Page 16
  758.  
  759.  
  760.       MUS-to-MEL Conversion Utility
  761.       -----------------------------
  762.  
  763.       File name is MUS2MEL.EXE.
  764.       This utility converts music from PIANOMAN's *.MUS files into
  765.       Melody Master's *.MEL files.  Use the PLAYER PIANO utility in
  766.       PIANOMAN to convert that program's files to *.MUS.  Don't expect
  767.       perfect results!  Be prepared to edit the resulting file!
  768.  
  769.  
  770.       
  771.       PAGING utility
  772.       --------------
  773.  
  774.       File name is PAGING.EXE.
  775.       Displays text files on the screen.
  776.  
  777.       
  778.       
  779.       PLAY command
  780.       ------------
  781.  
  782.       File  name is PLAY.EXE.
  783.       This command is used to play music in batch files using the
  784.       output from "Data File".  See the TECH.DOC file on the program
  785.       disk for more information.
  786.  
  787.  
  788. MELODY MASTER                                                   Page 17
  789.  
  790.  
  791.                       DESCRIPTION OF FILES
  792.  
  793.  
  794.       START   .BAT   -  Shows MELODY MASTER menu. Run this file first!
  795.     * MM      .EXE   -  Melody Master program
  796.     * MMCGA   .EXE   -  Melody Master for CGA or MCGA graphic cards
  797.     * MMCONFIG.EXE   -  Configuration utility
  798.       MUS2MEL .EXE   -  MUS-to-MEL Conversion Utility
  799.       PAGING  .EXE   -  Paging Utility
  800.       PLAY    .EXE   -  PLAY command (can be used in batch files)
  801.     * PLAY2MEL.EXE   -  PLAY-to-MEL Conversion Utility
  802.       MM      .DOC   -  This file!
  803.       NEW     .DOC   -  What's new in this version
  804.       SHR-WARE.DOC   -  About Shareware and ASP by Bob Falk
  805.       SPKR    .DOC   -  Documentation for SPKR.SYS by Cove Software
  806.       TECH    .DOC   -  Programmers' Music Development Kit
  807.       VENDOR  .DOC   -  Vendor information
  808.       INVOICE .TXT   -  Melody Master Registration Order Form
  809.       SUGGEST .TXT   -  User's response form
  810.       MMCONFIG.PAR   -  Configuration File
  811.       DEFAULT .PAR   -  File containing the original configuration
  812.       MUSIC   .PAS   -  Procedure PLAY for Turbo Pascal
  813.       PLARRAY .PAS   -  Turbo Pascal procedure to play "TP array"
  814.       SOUNDER .PAS   -  Nels Anderson's background music unit
  815.       PLAYBG  .C     -  Background music in C (for "TC bck-gr" format)
  816.       SOUNDSYS.C     -  Backgound music routines in C by Juan Jimenez
  817.       SOUNDSYS.H     -  Header file for SOUNDSYS.C
  818.       TONE    .C     -  tone() function for other C compilers
  819.       SPKR    .SYS   -  Background music driver by Cove Software
  820.       KEY     .COM   -  File used in START.BAT
  821.       FILE_ID .DIZ   -  Description file for PCBoard BBSs
  822.       MELODY20.EXE   -  The installation file containing compressed
  823.                         version of the entire Melody Master package.
  824.       MUSIC\         -  Directory for music files
  825.  
  826.    *  -  Files compressed using LZEXE v0.91 program
  827.  
  828.       
  829.  
  830. MELODY MASTER                                                   Page 18
  831.                      
  832.                
  833.     HOW TO GET HELP
  834.                                              
  835.                                           
  836.       We are dedicated in providing quality support for our product.
  837.       There are lots of ways to obtain technical assistance in
  838.       installing and/or using Melody Master. Shareable Software Int.
  839.       can be reached at:
  840.  
  841.          708-397-1221 (voice)
  842.          708-397-0381 (fax)
  843.          CompuServe:  76226,2652
  844.          Internet:    76226.2652@compuserve.com
  845.                                                                 
  846.       You can also call The Runway BBS at 215-623-6203, join
  847.       conference 77 and leave a message to BILL DICKSON or ALEXEI
  848.       EFROS. You will also be able to download the latest version of
  849.       Melody Master from there. See the first page of this manual for
  850.       mailing addresses.
  851.                                     
  852.       
  853.       
  854.     ABOUT THE AUTHOR
  855.  
  856.  
  857.       Alexei (Alyosha) Efros, Jr. was born in St. Petersburg
  858.       (Leningrad), in the former Soviet Union. He started his career
  859.       as a programmer at the age of 7 when his father taught him how
  860.       to use the B3-34 programming calculator which performed only
  861.       about 1/2 operation per second (when it was in a good mood!). He
  862.       then switched to the first Soviet PC, the BK-0010 which was
  863.       similar to a Commodore, but used a very old and strange language
  864.       called FOCAL. He wrote a number of programs in FOCAL including
  865.       LOGO interpreter.
  866.  
  867.       In 1989, his life changed dramatically when his family moved to
  868.       the United States.  He is currently in high school and plans on
  869.       becoming a computer scientist.
  870.  
  871.       Melody Master was one of the first and the largest program he
  872.       has written on an IBM compatible computer.  He began writing
  873.       Melody Master in May 1989.  Working only on the weekends, he
  874.       released the first version (v1.5) of the program in August 1990.
  875.       Although the initial effort gained little attention, the second
  876.       version (v1.6), released on April 9, 1991 (also his sixteenth
  877.       birthday), was a notable success.
  878.  
  879.       He has three main interests: eating ice cream (especially,
  880.       chocolate with nuts!), programming, and playing the piano.
  881.       
  882.  
  883.  
  884.  
  885. MELODY MASTER                                                   Page 19
  886.  
  887.  
  888.  
  889.  
  890.     ACKNOWLEDGEMENTS
  891.  
  892.  
  893.       This program is about three years old now.  A lot of people
  894.       have contributed to it along the way (directly or indirectly).
  895.       It is impossible to mention everyone here, but I will do my best
  896.       to acknowledge as many as I can.  In order of appearance:
  897.  
  898.         1986...
  899.       M. S. Gorbachev -- Thanks for starting PERESTROIKA!  Without it,
  900.       this program would not be on the market!
  901.  
  902.         1988...
  903.       Eugene Levin -- Thanks for teaching me all that neat stuff about
  904.       computers.
  905.  
  906.         1989...
  907.       Alexei L. Efros, Sr. (my dad) -- Thanks for buying me that
  908.       wonderful XT clone, my first PC!!!
  909.  
  910.       Mishka Levin -- Thanks for helping with the design of the
  911.       program. He was also the author of the original name "Song
  912.       Editor" because only he knew English at that time.
  913.       
  914.       Leonia Kamenkovich -- Thanks for teaching me all the music stuff
  915.       and helping with the program.
  916.  
  917.         1990...
  918.       ASP (especially, Bob Folk and Nelson Ford) -- Thanks for helping
  919.       me with the shareware business!  Hey, join ASP!  It pays!
  920.  
  921.         1991...
  922.       Nels Anderson and Christopher Dunford -- Thanks for letting me
  923.       include your programs in this package.
  924.  
  925.       East  High  School  Computer  Club (especially, Jason Dam) --
  926.       Thanks for beta testing, comments, and encouragement!
  927.                                                             
  928.       THANKS to everybody else whom I didn't mention here because of
  929.       the lack of space!
  930.  
  931.       All trademarks are the property of the respective manufacturers.
  932.